Выделяет новую строку и копирует в нее заданную строку. Возвращает NULL, если не хватает памяти или если параметр имеет значение NULL.

BSTR SysAllocString
( 
OLECHAR FAR* sz
);

Параметр
sz
Завершающаяся нулевым символом строка, которая копируется в новую BSTR. Параметр sz должен быть строкой Unicode в 32-разрядных приложениях и строкой ANSI — в 16-разрядных.

Возвращаемое значение
В случае успеха указывает на BSTR, содержащую заданную строку. При недостатке памяти или если sz равно NULL, возвращается NULL.

Комментарии
Строки, выделенные SysAllocString, освобождаются с помощью SysFreeString

Пример

inline void CStatBar::SetText(OLECHAR FAR* sz) 
{
SysFreeString(m_bstrMsg);
m_bstrMsg = SysAllocString(sz);
}